Skip to main content

Availability

In order to access the APIs, you should target a site through its URL along with:

http://[site-url]/api/jobboard/v1/{endpoint}

In the previous example, endpoint corresponds to the action you are calling.

API specifications

Response and Request Formats​

  • These APIs work only with JSON as their transport format.
  • All JSON properties are named in camel case starting by lower case (e.g. customFields).
  • Dates follow the ISO 8601 standard.

Implementation Recommendations

  • The number of API calls must be kept to a minimum.
  • Errors must be corrected.
  • Request only one token for a given user session. Avoid requesting a new token between each API call and only request a new token when the current one has expired (the duration is mentioned in the authorization response, in the field expires_in - see below in the Authorization section).

Authorization

In order to interact with the APIs, the application will need to be identified through a client_id and a client_secret, using the url http://[site-url]/api/token. You will get a token that must be in the Authorization header of each API call.

The protocol involved is OAuth2.

How to retrieve a token​

  • “As an application”:
    • POST https://[site-url]/api/token HTTP/1.1
    • Content-Type: application/x-www-form-urlencoded
    • In the body:
        - client_id=[clientID]
        - client_secret=[clientSecret]
        - grant_type=client_credentials
        - scope=JobBoard

The client_id and client_secret are unique per partner and per environment and can be configured by a Cegid technical consultant.

The response will contain the access token:

{
     "access_token": "433fKaLfINnJB46DhWIVFyoVmPzX3h7ZUauAfOaT046KyXqd0qFIkAa3MOAHHYgHKU9tF",
     "token_type": "bearer",
     "expires_in": 1199
}

The token obtained must be used in the Authorization header of every API call:

Authorization: bearer token, where token is the token retrieved.

How to use the access token​

  • GET /api/jobboard/v1/vacancies
    • In headers:
    Authorization = bearer 433fKaLfINnJB46DhWIVFyoVmPzX3h7ZUauAfOaT046KyXqd0qFIkAa3MOAHHYgHKU9tF

Cinematics

Cinematic of API calls to get all referentials needed for creating applications forms:​

  1. Retrieve a token “as an application” (grant_type=client_credentials): POST /api/token
  2. Get all referentials, by category (example for diplomas referential): GET /api/jobboard/v1/referentials/diplomas
  3. Get referentials translations using the id of a specific item. Two cases:
    • Get all available translations of referential item: GET /api/jobboard/v1/referentials/diplomas/{id}/translations
    • Get the item's translation in one specific language: GET /api/jobboard/v1/referentials/diplomas/{id}/translations/{lcid}

Cinematic of API calls to retrieve all vacancies available and display one:​

  1. Retrieve a token “as an application” (grant_type=credentials): POST /api/token
  2. Get a list of all vacancies: GET /api/jobboard/v1/vacancies
  3. Get the details of a specific vacancy: GET /api/jobboard/v1/vacancies/{vacancyReference}

Cinematic of API calls to create an application on a vacancy:​

  1. Retrieve a token “as an application” (grant_type=credentials): POST /api/token
  2. Get a list of all vacancies: GET /api/jobboard/v1/vacancies
  3. Get the details of a specific vacancy: GET /api/jobboard/v1/vacancies/{vacancyReference}
  4. Apply to selected vacancy (documents can be attached): POST /api/jobboard/v1/vacancies/{vacancyReference}/applications (see example in the end of this document)

Cinematic of API calls to follow up on a candidates applications status:​

  1. Retrieve a token “as an application” (grant_type=credentials): POST /api/token
  2. Retrieve a list of the candidate's applications: GET /api/jobboard/v1/candidates/{id}/applications

Note: For the list of available endpoints, more technical details on the Jobboard APIs as well as the full list of available referentials please visit the Cegid documentation page on this topic.

Example of the body of a request for the creation of an application​

To call the endpoint POST /api/jobboard/v1/vacancies/{vacancyReference}/applications the request body should be of the following structure:

    {"candidateInformation":{
          "lastName":"candidate_lastName",
          "firstName":"candidate_firstName",
          "phoneNumber":"0123456789",
          "email":"test@test.com",
          "personalEmail":"test@test.com"
        },
       "gdprInformation":{
          "personalDataConsentReceived":true,
          "retentionDelay":12
       }
    }

Note: The above is a minimal working example therefore it does not contain all available fields for a vacancy application. Depending on the client configuration, other fields, not mentioned, might be mandatory. For real applications, we encourage using additionally at least the fields educations, jobPreferences as well as location information fields included in the block personalInformation.